Skip to content

新增 Yar 协议章节并同步更新 Yar 扩展中文翻译 - #1065

Merged
sy-records merged 2 commits into
php:masterfrom
laruence:yar-docs-2026-08-30
Aug 30, 2026
Merged

新增 Yar 协议章节并同步更新 Yar 扩展中文翻译#1065
sy-records merged 2 commits into
php:masterfrom
laruence:yar-docs-2026-08-30

Conversation

@laruence

Copy link
Copy Markdown
Member

摘要

跟进英文文档修订(php/doc-en#5815,已合入),同步更新 reference/yar/ 全部中文翻译,EN-Revision 对齐 60ce1c5c7c

变更内容

1. 新增《Yar 协议》章节(置于安装章节之前)

  • 描述 82 字节二进制请求头布局、打包器标识前缀的消息体及网络字节序字段
  • 附带一个不依赖扩展、仅用标准 PHP 调用 Yar 服务的完整示例
  • 补充 YAR_ERR_FORBIDDEN 常量(服务端鉴权失败错误码,此前手册缺失)

2. 安装章节更新

  • 覆盖三种安装方式:PECL(标注已迁移)、PIE(pie install laruence/yar,含 --enable-msgpack 变体)以及从源码构建

3. 示例与使用说明完善

  • Yar_Client::call() 新增示例:魔法方法调用形式、显式按名调用形式,以及远程方法恰好叫 call 时为何需要显式调用
  • Yar_Concurrent_Client 补充设计动机(批量发起互相独立的调用,整体等待时间降为最慢单次调用)、仅支持 HTTP(S) 的原因(并发调用通过 curl multi-handle 接口发出,TCP/Unix socket 传输层未实现该能力)、callinfo 数组组成,以及未设置 callback/error_callback 时的兜底行为(直接打印返回值 / 触发 PHP 警告)

验证

  • doc-base/configure.php --with-lang=zh --with-partial=book.yar 校验通过
  • phd(PHP chunked XHTML 包)渲染无错误

跟进英文文档修订 (php/doc-en#5815, EN-Revision 60ce1c5c7c):
新增《Yar 协议》章节、三种安装方式(PECL/PIE/源码)、
YAR_ERR_FORBIDDEN 常量,完善并发客户端与核心方法文档。
Comment thread reference/yar/protocol.xml Outdated
@sy-records
sy-records merged commit eef6bfd into php:master Aug 30, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants